Obtains the current status of a Dial() or Transfer() operation.

Returns the status of the line.

• None.

$phoneno = "1234567890"

MAIN:
	
    display $deviceid " Dialing " $phoneno
    $stat = dial($phoneno)
	
    while true
        $stat = GetCallProgress()
        if $stat <> ""
            display $stat
    endif
		
        if $stat == "CONNECTED"
            display $deviceid "Call connected.."
            Play "welcome.wav"
            break
        else if find($stat,"DISCONNECTED") >= 0)
            break    
        endif
		
        sleep 250
    endwhile
	
    hangup
    goto MAIN

* User has hung up
ONHANGUP:
    hangup
    goto MAIN

* An error has occurred
ONSYSTEMERROR:
    log $error
    display $error
    if $debug 
        msgbox $error
    endif
    hangup
    goto MAIN

Possible values for $Status are :

• DIALTONE = Line is alive for number dialing in order to make a call.
• RINGBACK = The telephone corresponding to the dialed number has been found and it is ringing at the receiver's end.
• CONNECTED = Connection is established. Receiver attended the call.
• DISCONNECTED = The application initiated the disconnect of the call.
• DISCONNECTED-BUSY = The remote end is busy and could not take the call. This disconnect reason is only signaled for outgoing calls.
• DISCONNECTED-REJECT = The call was rejected by the remote peer.
• DISCONNECTED-NOANSWER = The remote end did not answer the call and the call timed out. This disconnect reason is only signaled for outgoing calls.
• DISCONNECTED-ALERT_NOANSWER = The remote end did not answer the call even though it sent an alert to keep the call ringing. This disconnect reason is only signaled for outgoing calls.
• DISCONNECTED-NUMUNKNOWN = The switch responds that the dialed number is not known.
• DISCONNECTED-NUMINVALID = The switch responds that the dialed number is not in a valid format or not complete.
• DISCONNECTED-NUMCHANGED = The switch responds that the dialed number is not known because it has changed.
• DISCONNECTED-NOCHANNEL = All channels on the line device are already in use.
• DISCONNECTED-CABLEERR = There is no layer 1 connection between the line device and the switch. This is typically a cable error or an un-plugged line device.
• DISCONNECTED-NETWORKERR = A general network error occurred during call establishment.
• DISCONNECTED-NUMNOTALLOC = The dialed number is no longer available.
• UNKNOWN = There is no specific information why the call failed.

* The above information is subject to change.